home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / chpmv.z / chpmv
Encoding:
Text File  |  2002-10-03  |  14.5 KB  |  265 lines

  1.  
  2.  
  3.  
  4. CCCCHHHHPPPPMMMMVVVV((((3333SSSS))))                                                            CCCCHHHHPPPPMMMMVVVV((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CCCCHHHHPPPPMMMMVVVV, ZZZZHHHHPPPPMMMMVVVV - Multiplies a complex vector by a packed complex Hermitian
  10.      matrix
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      Single precision complex
  14.  
  15.           Fortran:
  16.                CCCCAAAALLLLLLLL CCCCHHHHPPPPMMMMVVVV ((((_u_p_l_o,,,, _n,,,, _a_l_p_h_a,,,, _a_p,,,, _x,,,, _i_n_c_x, _b_e_t_a,,,, _y,,,, _i_n_c_y))))
  17.  
  18.           C/C++:
  19.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  20.                vvvvooooiiiidddd cccchhhhppppmmmmvvvv ((((cccchhhhaaaarrrr *_u_p_l_o,,,, iiiinnnntttt _n,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_a_l_p_h_a,,,,
  21.                ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_a_p,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx
  22.                *_b_e_t_a,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_y,,,, iiiinnnntttt _i_n_c_y))));;;;
  23.  
  24.           C++ STL:
  25.                ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>>
  26.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  27.                vvvvooooiiiidddd cccchhhhppppmmmmvvvv ((((cccchhhhaaaarrrr *_u_p_l_o,,,, iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_a_l_p_h_a,,,,
  28.                ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_a_p,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_x,,,, iiiinnnntttt _i_n_c_x,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>>
  29.                *_b_e_t_a,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_y,,,, iiiinnnntttt _i_n_c_y))));;;;
  30.  
  31.      Double precision complex
  32.  
  33.           Fortran:
  34.                CCCCAAAALLLLLLLL ZZZZHHHHPPPPMMMMVVVV ((((_u_p_l_o,,,, _n,,,, _a_l_p_h_a,,,, _a_p,,,, _x,,,, _i_n_c_x, _b_e_t_a,,,, _y,,,, _i_n_c_y))))
  35.  
  36.           C/C++:
  37.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  38.                vvvvooooiiiidddd zzzzhhhhppppmmmmvvvv ((((cccchhhhaaaarrrr *_u_p_l_o,,,, iiiinnnntttt _n,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_a_l_p_h_a,,,,
  39.                ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_a_p,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx
  40.                *_b_e_t_a,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_y,,,, iiiinnnntttt _i_n_c_y))));;;;
  41.  
  42.           C++ STL:
  43.                ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>>
  44.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  45.                vvvvooooiiiidddd zzzzhhhhppppmmmmvvvv ((((cccchhhhaaaarrrr *_u_p_l_o,,,, iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_a_l_p_h_a,,,,
  46.                ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_a_p,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_x,,,, iiiinnnntttt _i_n_c_x,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>>
  47.                *_b_e_t_a,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_y,,,, iiiinnnntttt _i_n_c_y))));;;;
  48.  
  49. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  50.      These routines are part of the SCSL Scientific Library and can be loaded
  51.      using either the ----llllssssccccssss or the ----llllssssccccssss____mmmmpppp option.  The ----llllssssccccssss____mmmmpppp option
  52.      directs the linker to use the multi-processor version of the library.
  53.  
  54.      When linking to SCSL with ----llllssssccccssss or ----llllssssccccssss____mmmmpppp, the default integer size is
  55.      4 bytes (32 bits). Another version of SCSL is available in which integers
  56.      are 8 bytes (64 bits).  This version allows the user access to larger
  57.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  58.      by using the ----llllssssccccssss____iiii8888 option or the ----llllssssccccssss____iiii8888____mmmmpppp option. A program may use
  59.      only one of the two versions; 4-byte integer and 8-byte integer library
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCHHHHPPPPMMMMVVVV((((3333SSSS))))                                                            CCCCHHHHPPPPMMMMVVVV((((3333SSSS))))
  71.  
  72.  
  73.  
  74.      calls cannot be mixed.
  75.  
  76.      The C and C++ prototypes shown above are appropriate for the 4-byte
  77.      integer version of SCSL. When using the 8-byte integer version, the
  78.      variables of type iiiinnnntttt become lllloooonnnngggg lllloooonnnngggg and the <<<<ssssccccssssllll____bbbbllllaaaassss____iiii8888....hhhh>>>> header
  79.      file should be included.
  80.  
  81. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  82.      These routines perform the following matrix-vector operation:
  83.  
  84.           _y <- _a_l_p_h_a _A_x + _b_e_t_a _y
  85.  
  86.      where _a_l_p_h_a and _b_e_t_a are complex scalars, _x and _y are _n-element vectors,
  87.      and _A is an _n-by-_n packed complex Hermitian matrix.
  88.  
  89.      See the NOTES section of this man page for information about the
  90.      interpretation of the data types described in the following arguments.
  91.  
  92.      These routines have the following arguments:
  93.  
  94.      _u_p_l_o      Character.  (input)
  95.                Specifies whether the upper or lower triangular part of matrix
  96.                _A is packed into the array argument _a_p, as follows:
  97.  
  98.                _u_p_l_o= 'U' or 'u': the upper triangular part of _A is being
  99.                supplied in the argument _a_p.
  100.                _u_p_l_o= 'L' or 'l': the lower triangular part of _A is being
  101.                supplied in the argument _a_p.
  102.  
  103.                For C/C++, a pointer to this character is passed.
  104.  
  105.      _n         Integer.  (input)
  106.                Specifies the order of matrix _A.  _n >= 0.
  107.  
  108.      _a_l_p_h_a     Scalar alpha.
  109.                CCCCHHHHPPPPMMMMVVVV: Single precision complex.
  110.                ZZZZHHHHPPPPMMMMVVVV: Double precision complex.
  111.  
  112.                For C/C++, a pointer to this scalar is passed.
  113.  
  114.      _a_p        Array of dimension (_n(_n+1))/2 .  (input)
  115.                CCCCHHHHPPPPMMMMVVVV: Single precision complex array.
  116.                ZZZZHHHHPPPPMMMMVVVV: Double precision complex array.
  117.  
  118.                Before entry with _u_p_l_o = 'U' or 'u', array _a_p must contain the
  119.                upper triangular part of the Hermitian matrix packed
  120.                sequentially, column-by-column, so that _a_p(1) contains _A(1,1),
  121.                _a_p(2) contains _A(1,2), _a_p(3) contains _A(2,2), and so on.
  122.  
  123.                Before entry with _u_p_l_o = 'L' or 'l', array _a_p must contain the
  124.                lower triangular part of the Hermitian matrix packed
  125.                sequentially, column-by-column, so that _a_p(1) contains _A(1,1),
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CCCCHHHHPPPPMMMMVVVV((((3333SSSS))))                                                            CCCCHHHHPPPPMMMMVVVV((((3333SSSS))))
  137.  
  138.  
  139.  
  140.                _a_p(2) contains _A(2,1), _a_p(3) contains _A(3,1), and so on.
  141.  
  142.      _x         Array of dimension 1+(_n-1) * |_i_n_c_x|.  (input)
  143.                CCCCHHHHPPPPMMMMVVVV: Single precision complex array.
  144.                ZZZZHHHHPPPPMMMMVVVV: Double precision complex array.
  145.                Contains vector _x.
  146.  
  147.      _i_n_c_x      Integer.  (input)
  148.                Specifies the increment for the elements of _x.  _i_n_c_x must not
  149.                be 0.
  150.  
  151.      _b_e_t_a      Scalar beta.  (input)
  152.                CCCCHHHHPPPPMMMMVVVV: Single precision complex.
  153.                ZZZZHHHHPPPPMMMMVVVV: Double precision complex.
  154.                If _b_e_t_a is supplied as 0, _y need not be set on input.
  155.  
  156.                For C/C++, a pointer to this scalar is passed.
  157.  
  158.      _y         Array of dimension 1+(_n-1) * |_i_n_c_y|.  (input and output)
  159.                CCCCHHHHPPPPMMMMVVVV: Single precision complex array.
  160.                ZZZZHHHHPPPPMMMMVVVV: Double precision complex array.
  161.                Contains vector _y.  On exit, _y is overwritten by updated vector
  162.                _y.
  163.  
  164.      _i_n_c_y      Integer.  (input)
  165.                Specifies the increment for the elements of _y.  _i_n_c_y must not
  166.                be 0.
  167.  
  168. NNNNOOOOTTTTEEEESSSS
  169.      CCCCHHHHPPPPMMMMVVVV/ZZZZHHHHPPPPMMMMVVVV is a Level 2 Basic Linear Algebra Subprogram (Level 2 BLAS).
  170.  
  171.      When working backward (_i_n_c_x < 0 or _i_n_c_y < 0), this routine starts at the
  172.      end of the vector and moves backward, as follows:
  173.  
  174.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)) , ..., _x(1)
  175.  
  176.           _y(1-_i_n_c_y * (_n-1)), _y(1-_i_n_c_y * (_n-2)) , ..., _y(1)
  177.  
  178.  
  179.    DDDDaaaattttaaaa TTTTyyyyppppeeeessss
  180.      The following data types are described in this documentation:
  181.  
  182.           TTTTeeeerrrrmmmm UUUUsssseeeedddd                     DDDDaaaattttaaaa ttttyyyyppppeeee
  183.  
  184.      Fortran:
  185.  
  186.           Array dimensioned _n           xxxx((((nnnn))))
  187.  
  188.           Character                     CCCCHHHHAAAARRRRAAAACCCCTTTTEEEERRRR
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. CCCCHHHHPPPPMMMMVVVV((((3333SSSS))))                                                            CCCCHHHHPPPPMMMMVVVV((((3333SSSS))))
  203.  
  204.  
  205.  
  206.           Integer                       IIIINNNNTTTTEEEEGGGGEEEERRRR (IIIINNNNTTTTEEEEGGGGEEEERRRR****8888 for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  207.  
  208.           Single precision complex      CCCCOOOOMMMMPPPPLLLLEEEEXXXX
  209.  
  210.           Double precision complex      DDDDOOOOUUUUBBBBLLLLEEEE CCCCOOOOMMMMPPPPLLLLEEEEXXXX
  211.  
  212.      C/C++:
  213.  
  214.           Array dimensioned _n           xxxx[[[[_n]]]]
  215.  
  216.           Character                     cccchhhhaaaarrrr
  217.  
  218.           Integer                       iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  219.  
  220.           Single precision complex      ssssccccssssllll____ccccoooommmmpppplllleeeexxxx
  221.  
  222.           Double precision complex      ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx
  223.  
  224.      C++ STL:
  225.  
  226.           Array dimensioned _n           xxxx[[[[_n]]]]
  227.  
  228.           Character                     cccchhhhaaaarrrr
  229.  
  230.           Integer                       iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  231.  
  232.           Single precision complex      ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>>
  233.  
  234.           Double precision complex      ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>>
  235.  
  236. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  237.      IIIINNNNTTTTRRRROOOO____SSSSCCCCSSSSLLLL(3S), IIIINNNNTTTTRRRROOOO____BBBBLLLLAAAASSSS2222(3S), SSSSSSSSPPPPMMMMVVVV(3S)
  238.  
  239.      IIIINNNNTTTTRRRROOOO____CCCCBBBBLLLLAAAASSSS(3S) for information about using the C interface to Fortran 77
  240.      Basic Linear Algebra Subprograms (legacy BLAS) set forth by the Basic
  241.      Linear Algebra Subprograms Technical Forum.
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.                                                                         PPPPaaaaggggeeee 4444
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.